home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Whiteline: delta
/
whiteline CD Series - delta.iso
/
progtool
/
c
/
pc_shell
/
pc_hyp
/
pc_shell.txt
< prev
next >
Wrap
Text File
|
1995-11-25
|
58KB
|
2,075 lines
Dokumentation zur PC-Shell V3.00 (17.06.1995)
=============================================
Stand: 23.07.1995
o Allgemeines
o PC-Shell - Menü
o PC-Shell - Editor
o PC-Shell - Projekte
o Shareware
o Lieferumfang
o Installation
o PC-Shell History
Allgemeines
===========
PC-Shell ist eine Alternative zur Pure C - Shell (PC.PRG)
für die Anwender des Pure C - Compilers.
Die Highlights der PC-Shell sind:
o Ersetzt PC.PRG
o Compilierung im Hintergrund unter MagiC und MTOS
o Unterstützt wahlweise PC_HELP oder ST-Guide
o Kontext-Hilfe für ST-Guide
Alle Dialoge enthalten einen Hilfe-Button, über den in die
entsprechende Seite der Online-Hilfe verzweigt werden kann.
o Komfortable Projekterstellung
Projekte werden über ein Projektfenster verwaltet, das sich
intuitiv bedienen läßt.
(Listboxen, Drag & Drop, Icons, Unterstützung von Selectric)
o Unterstützung von Subprojekten
Projekte können weitere (Sub-) Projekte als Abhängigkeiten
enthalten.
o Dateibeschreibungen
Jede Source-Datei in einem Projekt kann mit einer Beschreibung
(< 32kB) versehen werden.
o Source-Compiler
Es können auch Source-Dateien im Projekt verwaltet werden, die
weder C- noch Assembler-Sourcen sind. Für solche Dateien kann
jeweils ein Source-Compiler eingestellt werden, der diese Dateien
bearbeitet. So können z.B. in einem Projekt aller Sourcen eines
Programms und auch die ST-Guide - Beschreibung verwaltet werden.
o Eingebauter Editor (PC-Editor)
o Externe Editoren
Alternativ zum PC-Editor werden von der PC-Shell bis zu
2 externe Editoren unterstützt.
o Aufruf des RCS
Es kann ein RCS ausgewählt werden, daß zur Bearbeitung von
Resourcen automatisch gestartet wird.
o ACS-Unterstützung
Laden und erstellen von ACS-Modulen (ab ACS V2.20).
o Programmstart über F-Tasten
Die Funktionstasten F1 - F10 können frei mit Programmen belegt
werden.
o Import/Export von .PRJ - Dateien
PC-Shell verwendet für Projekte ein eigenes Format in den .PC-
Dateien. Es können jedoch .PRJ-Dateien sowohl gelesen als auch
erzeugt werden.
PC-Shell - Menü
===============
Das Menü der PC-Shell enthält die folgenden Einträge:
o PC_SHELL
o Datei
o Editor
o Compiler
o Optionen
o Extras
o Hilfe
PC-Shell - Menü: PC_SHELL
=========================
o Info...
Programm-Info und Registrierung:
Durch anklicken des Buttons "Registrieren" erscheint der
Registrier-Dialog.
Hier gibt man den Namen an, den man dem Autor bei der Registrierung
mitgeteilt hat und den vom Autor zugesandten Schlüssel. Nach der
Eingabebestätigung ("OK") teilt die PC-Shell mit, ob die
Registrierung erfolgreich wahr. Im Falle einer erfolgreichen
Registrierung muß man noch die .INF - Datei ("PC_SHELL.INF")
sichern, damit die Registrierung auch über das Programmende hinaus
bekannt bleibt.
PC-Shell - Menü: Datei
======================
o PC neu... ^N
Neues Projekt öffnen.
Mit dem Fileselektor wird der Name der Projektdatei (*.PC)
angegeben.
o PC öffnen... ^P
Öffnet eine (schon vorhandene) Projektdatei (*.PC).
o PC sichern ^J
Sichert die geöffnete Projektdatei.
o PC sichern als...
Sichert die geöffnete Projektdatei, wobei ein anderer Projektname
eingegeben werden kann.
o PRJ öffnen... ◆P
Öffnet eine original Pure C - Projektdatei (*.PRJ).
o PRJ sichern... ◆J
Sichert die geöffnete Projektdatei als Pure C - Projektdatei
(*.PRJ).
o beenden ^Q
Beenden der PC-Shell.
PC-Shell - Menü: Editor
=======================
o *.C editieren... ^O
*.C - Datei (C-Source) editieren.
Dateiauswahl über Fileselektor.
o *.S editieren...
*.S - Datei (Assembler-Source) editieren.
Dateiauswahl über Fileselektor.
o *.H editieren...
*.H - Datei (C-GIncludedatei) editieren.
Dateiauswahl über Fileselektor.
o *.* editieren...
*.* - Datei (beliebige Textdatei) editieren.
Dateiauswahl über Fileselektor.
o Projekt-Suche... ◆B
Durchsucht alle im Projekt angegebenen Source- und
Abhängigkeitsdateien nach einer Zeichenkette.
(Abbruch durch LinksSHIFT + RechtsSHIFT)
Die gefundenen Textstellen werden in einem Fenster
ausgegeben, und zwar in der Form:
- Datei-Name, Zeile, Inhalt der Zeile.
Durch Mausklick auf diese Zeile wird die Datei in den zugeordneten
Editor (bestimmt durch die Auswahl in 'Optionen/Source-Liste...'
bzw 'Extras/Diverse...') geladen. Bei Verwendung des internen
Editors (PC-Editor) wird der Cursor automatisch auf die betreffende
Textstelle gesetzt.
Bei manchen Editoren, wie z.B. EVEREST, ist es auch möglich, das
der Editor, durch Doppelklick auf eine Fehlermeldung, den Cursor
in die dazugehörige Zeile der Sourcedatei setzt.
PC-Shell - Menü: Compiler
=========================
o Compilieren... ◆C
Compiliert eine mit dem Fileselektor ausgewählte Datei.
o Assemblieren... ◆A
Assembliert eine mit dem Fileselektor ausgewählte Datei.
o Make ◆M
Erzeugt, aus den im Projektfenster angegebenen Source- und
Library-Dateien, die unter 'Programm-Name' angegebene Datei.
Es werden nur die geänderten Sourcedateien compiliert bzw.
assembliert. Ob Dateien verändert wurden, wird am Datum und Zeit
der Datei festgestellt. Deshalb ist es wichtig, das die Rechneruhr
die aktuelle Uhrzeit und Datum enthält.
Sind im Projekt Subprojekte enthalten, so wird auch für alle
Subprojekte 'Make' ausgelöst.
o Make All ◆X
Erzeugt, aus den im Projektfenster angegebenen Source- und
Library-Dateien, die unter 'Programm-Name' angegebene Datei.
Es werden alle Sourcedateien neu compiliert bzw. assembliert.
Sind im Projekt Subprojekte enthalten, so wird auch für alle
Subprojekte 'Make All' ausgelöst.
Die Projekterzeugung kann durch längeres drücken der beiden
SHIFT-Tasten abgebrochen werden.
o Linken
Linkt das Projekt.
Sind im Projekt Subprojekte enthalten, so wird auch für alle
Subprojekte 'Linken' ausgelöst.
o Prg. debuggen ◆D
Übergibt das vom Projekt erzeugte Programm an den Pure C -
Debugger.
o Prg. profilen
Übergibt das vom Projekt erzeugte Programm an den Pure -
Profiler.
(Nicht unter MTOS)
o Prg. starten ◆R
Startet das vom Projekt erzeugte Programm.
PC-Shell - Menü: Optionen
=========================
o Compiler... ◆U
Einstellen der Compiler-Optionen.
o Assembler... ◆I
Einstellen der Assembler-Optionen.
o Linker... ◆O
Einstellen der Linker-Optionen.
o Def. sichern
Default-Einstellungen sichern von:
- Compiler-, Assembler- und Linker-Optionen
(Die Include und Lib-Directorys werden nur in der
INF-Datei gesichert)
- Library-Dateien
- Pfad für den Prg-Namen
Die Defaulteinstellungen werden nur beim erstellen einer neuen
*.PC-Datei (PC neu...) verwendet.
o Pfade... ◆Z
Einstellen der Programmpfade.
o Programme... ◆G
Auswählen von Programmen die über die Funktionstasten F1 - F10
gestartet werden können.
o Source-Liste...
Zusätzliche Source-Editoren mit konfigurierbaren Datei-Extendern.
Ist z.B. das ACS.PRG für den Datei-Extender *.ACS eingetragen,
wird für das editieren einer *.ACS Datei das ACS.PRG geladen.
o INF sichern...
Sichern der PC_SHELL.INF Datei, sie enthält:
- Die in 'Optionen/Pfade...', 'Optionen/Programme...',
'Optionen/Source-Liste...' und 'Extras/Diverse...'
vorgenommenen Einstellungen.
- Die in 'Optionen/Compiler...', 'Optionen/Assembler...'
und 'Optionen/Linker...' angegebenen Include- und Library-
Directories.
- Zuletzt benutzter Pfad bei 'Extras/Module laden...'.
- Die Position und Größe der einzelnen Fenster.
- Alle geöffneten Fenster.
- Die geladene Projektdatei.
- Den Registrierschlüssel.
o INF laden... ◆H
Laden einer INF-Datei.
Hier werden die für das aktuelle Projekt globalen Compileroptionen
eingestellt.
Siehe auch
Pure C - Compilerhandbuch
Anhang B : PCC
o A - Nur ANSI-Standard zugelassen
Alle nicht ANSI/ISO konformen Erweiterungen sind nicht erlaubt.
Z.B. die Pure C spezifischen Spracherweiterungen cdecl und pascal
sind nach dem Setzen dieser Option nicht mehr erlaubt.
o B - DRI-Object Format erzeugen
Objekte werden im DRI (Digital Research) - Objektformat erzeugt.
Wichtig: im DRI-Format werden globale Symbole nur in den ersten
8 Zeichen unterschieden, wobei nicht zwischen Groß- und Klein-
schreibung unterschieden wird.
o C - Verschachtelte Kommentare
Verschachtelte C-Kommentare sind zulässig.
o G - Programmgrößen-Optimierung
Programm-Optimierung in Hinblick auf die Programmgröße.
Defaultmäßig werden Programme laufzeitoptimeirt.
o H - cdecl-Parameterübergabe
Übergabe aller Funktionsparameter über den Stack nach der cdecl
Calling Convention: Funktionsparameter werden von rechts nach
links auf dem Stack abgelegt. Die aufrufende Funktion hat für
die Stackkorrektur nach Abschluß der Funktion zu sorgen.
o J - Prg-prünge nicht optimieren
Sprungbefehle werden nicht optimiert.
o K - char Datentyp ist unsigned
Alle Variablen/Funktionen vom Typ char werden behandelt wie
unsigned char.
Default: char <--> signed char
o M - Strings nicht zusammenlegen
Identische Strings werden nicht zusammengelegt.
o N - Objekt-Datei in Verzeichnis
Die Objekt-Dateien werden nicht im aktuellen Directory (Projekt-
Directory) erzeugt, sondern im angegebenen Directory.
Durch anklicken des Editfeldes kann mit dem Fileselektor das
Directory ausgewählt werden.
o P - Absolute Unterprogramm-Aufrufe
Unterprogramm-Aufrufe, die nicht im selben Modul liegen, werden
absolut adressiert.
Default: PC-relative Adressierung.
o Q - pascal-Parameterübergabe
Funktionsparameter werden von links nach rechts auf dem Stack
abgelegt. Die aufrufende Funktion hat für die Stackkorrektur nach
Abschluß der Funktion zu sorgen.
o R - Keine Register-Variablen
Es werden keine Register-Variablen verwendet.
o S - LINK und UNLINK verwenden
Es wird der Standardstackaufbau, unter Verwendung der Assembler-
anweisungen LINK und UNLINK, erzwungen.
o T - Stack Laufzeit-Überprüfung
Bei jedem Funktionsaufruf wird der Stack überprüft.
o V - Protokoll ausgeben
Protokoll der Compilierung ausgeben.
o X - Vor jedem Symbol '_' setzen
Vor jedem Symbol (Variable/Funktion) wird ein Underbar ('_')
generiert.
o Y - Debugger-Info's einfügen
Es werden Informationen für den Pure Debugger erzeugt.
o Z - Keine Registeroptimierung
Es wird keine Optimierung der Nutzung der Registervariablen
durchgeführt. Damit wird sichergestellt, daß eine Register-
variable jedesmal neu geladen wird, wenn ein Zugriff erfolgt.
o 2 - Code für 68020 erzeugen
Es wird Code für den MC68020 erzeugt.
o 8 - Code für 68881 erzeugen
Es wird Code für die FPU 68881/2 erzeugt.
Zu so compilierten Objects muß statt der PCFLTLIB.LIB die
PC881LIB.LIB dazugebunden werden.
o Zusatz-Optionen
Hier können die Optionen -Dmacro[=value] und -Umacro verwendet
werden, sowie die Warning-Optionen von Pure C.
o Include directory
Durch anklicken des Editfeldes erscheint eine Pop-UP - Box, in
der, mit Hilfe des Fileselektors, bis zu 2 x 4 Directories vor-
gegeben werden können, in denen der Compiler nach Include-Dateien
sucht.
Die ersten 4 Directories gehören zur Grundeinstellung und werden
in der .INF - Datei gesichert. Die anderen 4 Directories sind
projektspezifische Include-Directories und werden in der ent-
sprechenden .PC- bzw .PRJ-Datei gesichert.
o Compiler-Halt nach ... Fehlern
Hier kann eingestellt werden, nach wievielen Fehlern der Compiler
die Bearbeitung abbricht.
o Compiler-Halt nach ... Warnungen
Hier kann eingestellt werden, nach wievielen Warnungen der
Compiler die Bearbeitung abbricht.
o Warnstufe (0 - 2)
0 : keine Warnungen
1 : alle Default-Warnungen aktiv
2 : alle Warnungen aktiv
Liste der Warnungen ==>
o Maximale Länge der Bezeichner
Hier kann eingestellt werden, bis zu welcher Länge globale
Symbole (Variablen, Prozeduren) unterschieden werden.
Der Pure C - Compiler unterstützt die folgenden hier angegebenen
Warnungsoptionen. Alle mit (DEF) markierten Warnungen sind bei der
Warnstufe 1 aktiviert. Im allgemeinen sollte immer die Warnstufe 2
gewählt werden, um ein maximale Portabilität der Sourcen zu
gewährleisten.
Verletzungen des ANSI - Standards
-Wdup (DEF)
Redefinition von '...' ist nicht identisch.
-Wret (DEF)
Die return-Anweisungen der Funktion '...' liefern sowohl einen
Wert als auch keinen (nur return;).
-Wstr (DEF)
'...' ist nicht Bestandteil einer Struktur.
-Wstu (DEF)
Struktur '...' nicht definiert.
-Wsus (DEF)
Verdächtige Pointer-Umwandlung.
-Wvoi (DEF)
void-Funktionen dürfen kein Ergebnis zurückgeben.
-Wzst (DEF)
Struktur hat Länge 0.
Häufig auftretende Fehler
-Waus (DEF)
'...' erhält einen Wert zugewiesen, der nicht weiter verwendet
wird.
-Wdef (DEF)
'...' wird vor der Zuweisung eines Wertes verwendet.
-Weff (DEF)
Wirkungsloser Code.
-Wpar (DEF)
Parameter '...' wird nicht verwendet.
-Wpia (DEF)
Zuweisung möglicherweise falsch.
-Wrch (DEF)
Programm-Code nicht erreichbar.
-Wrvl (DEF)
Funktion sollte einen Wert zurückliefern.
Weniger häufige Fehler
-Wamb
Mehrdeutige Operatoren sollten mit Klammern gegliedert werden.
-Wamp
Überflüssiger Adreß-Operator vor Funktion oder Array.
-Wnod
Funktion '...' nicht deklariert.
-Wpro (DEF)
Funktionsaufruf ohne Prototyp.
-Wstv
Strukur als Wert übergeben.
-Wuse
'...' deklariert aber nicht verwendet.
Warnungen vor Portabilitätsproblemen
-Wapt (DEF)
Pointer-Zuweisung ist nicht portabel.
-Wcln
long - Konstante
-Wcpt (DEF)
Pointer-Vergleich ist nicht portabel.
-Wrng (DEF)
Konstante zu groß in einem Vergleichsausdruck.
-Wsig
Verlust signifikanter Stellen bei einer Umwandlung.
-Wucp
Es werden gemischte Pointer auf signed char und unsigned char
verwendet.
-Wrpt (DEF)
Nicht portabele Umwandlung bei einer Ergebnis-Rückgabe.
Einzelne Warnungsoptionen lassen sich auch gezielt abschalten. Will
man z.B. die Option -Wpro abschalten, so gibt man bei den Zusatz-
optionen -W-pro an.
Die Warnungsoptionen können auch in der Source ein- bzw ausge-
schaltet werden:
#pragma warn +cln (entspricht: -Wcln)
#pragma warn -cln (entspricht: -W-cln)
Hier werden die für das aktuelle Projekt globalen Assembleroptionen
eingestellt.
Siehe auch
Pure C - Assemblerhandbuch
Anhang A : Kommandozeilenparameter
o A - Alle Makros expandiert ausgeben
o B - DRI-Objekt Format erzeugen
Objekte werden im DRI (Digital Research) - Objektformat erzeugt.
Wichtig: im DRI-Format werden globale Symbole nur in den ersten
8 Zeichen unterschieden, wobei nicht zwischen Groß- und Klein-
schreibung unterschieden wird.
o C - Include-Dateien nicht ausgeben
o F - Nicht zutreffende Teile der bedingten Assemblierung nicht
ausgeben
o M - Keine Makro-Zeilen ausgeben
o N - Objekt-Datei in Verzeichnis
Die Objekt-Dateien werden nicht im aktuellen Directory (Projekt-
Directory) erzeugt, sondern im angegebenen Directory.
Durch anklicken des Editfeldes kann mit dem Fileselektor das
Directory ausgewählt werden.
o P - Listing ausgeben
Es wird ein Listing erzeugt (.LST - Datei).
o S - Supervisor-Befehle zulassen
Supervisor Calls dürfen verwendet werden.
o U - Undefinierte Symbole werden extern deklariert
o V - Ausführlichen Bericht ausgeben
Protokoll der Assemblierung ausgeben.
o Y - Informationen für Pure Debugger erzeugen
Es werden Informationen für den Pure Debugger erzeugt.
o 1 - 68010-Befehle zulassen
o 2 - 68020-Befehle zulassen
o 3 - 68030-Befehle zulassen
o 4 - 68040-Befehle zulassen
o 5 - 68851-Befehle zulassen
o 8 - 68881-Befehle zulassen
o Zusatz-Optionen
Hier können Optionen der Form -D=macro[=value] verwendet
werden.
o Include-Directory
Durch anklicken des Editfeldes erscheint eine Pop-UP - Box, in
der, mit Hilfe des Fileselektors, bis zu 4 + 2 Directories vor-
gegeben werden können, in denen der Assembler nach Include-Dateien
sucht.
Die ersten 4 Directories gehören zur Grundeinstellung und werden
in der .INF - Datei gesichert. Die anderen 2 Directories sind
projektspezifische Include-Directories und werden in der ent-
sprechenden .PC- bzw .PRJ-Datei gesichert.
Hier werden für das aktuelle Projekt die Linkeroptionen
eingestellt.
Siehe auch
Pure C - Assemblerhandbuch
Anhang C : Der Pure Linker
o F - Fastload-Bit nicht setzen
o G - Globale Symbole in Symboltabelle einfügen
o J - Neue Objektdatei (*.O) erzeugen
o L - Lokale Symbole in Symboltabelle einfügen
o M - Malloc-Aufrufe reservieren ST-RAM (nur TT)
o R - Das Program wird in ST-RAM geladen (nur TT)
o V - Link-Informationen ausgeben
o Y - Informationen für Pure Debugger einfügen
o Startup
Name der Objektdatei mit dem C-Startupcode.
(Auswahl mit Fileselektor)
o Library directory
Directory, in dem die Pure C - Libraries stehen.
(Auswahl mit Fileselektor)
o TEXT-Segment Adresse
Vorgabe der Startadresse des TEXT-Segmentes bei relozierbarem
Code.
o DATA-Segment Adresse
Vorgabe der Startadresse des DAAT-Segmentes bei relozierbarem
Code.
o BSS -Segment Adresse
Vorgabe der Startadresse des BSS-Segmentes bei relozierbarem
Code.
o Stack
Vorgeben einer Stackgröße für das Programm.
Default: 4096 Bytes
o Heap (nur TT)
Angabe, wieviel Speicher das Programm mindestens benötigt.
Zulässige Werte: 128kB bis 2048kB in Schritten von 128kB.
o Editor-1
Auswahl des Editor-1
o Editor-2
Auswahl des Editor-2
o RCS
Auswahl des Resource Construction Sets
o Pure-C
In diesem Verzeichnis müssen sich die Pure C - Programme
befinden:
PD.PRG, PASM.TTP, PCC.TTP, PLINK.TTP, PROFILER.PRG
Hinweis für Pure - Profiler - Benutzer ==>
o Hilfe-Prg
Pfad des PC_HELP - Programmes
Dieser Eintrag ist nur notwendig, wenn PC_HELP nicht als Accessory
läuft und von PC_SHELL.APP zur Laufzeit gestartet werden soll.
o Editor-1 Parameter
Parameter zum Aufruf von Editor-1
o Editor-2 Parameter
Parameter zum Aufruf von Editor-2
Pure C und Pure - Profiler benutzen verschiedene Formate für die
.HLP - Dateien. Werden z.B. PD.PRG und PROFILER.PRG im selben
Directory abgelegt, so kommt es zu Namenskonflikten bei den .HLP -
Dateien.
Abhilfe: Im Pure - Profiler kann man unter 'Options/Environment...'
den Suchpfad für die .HLP - Dateien einstellen. Man kann deshalb z.B.
im Pure-C - Pfad ein Directory PROFILER.HLP anlegen und dort die
.HLP - Dateien des Pure - Profilers ablegen.
In der PC-Shell können die Funktionstasten F1 - F10 frei mit
Programmen belegt werden.
o Parameter
Hier können die Parameter beschrieben werden, die beim
Programmstart mitübergeben werden sollen.
o Programm
Es erscheint der Fileselektor, mit dem man ein Programm
auswählen kann.
o Halt nach Programende
Es wird am Programmende der Programm-Status (Exit-Code)
ausgegeben und auf eine Eingabe gewartet.
(Nicht unter MagiC, da die Programme parallel gestartet werden)
o Starten
Das ausgewählte Programm wird mit den angegebenen Parametern
gestartet.
Es können bis zu 4 verschiedene Editoren (A-D) ausgesucht werden,
die zur Bearbeitung der im Projektfenster zusätzlich (zu Programm-
sourcen) angegebenen Dateien dienen. Jedem Editor können mehrere
Dateitypen (gleich Datei-Extender) zugeordnet werden.
Ist z.B. das ACS.PRG für den Datei-Extender *.ACS eingetragen, wird
für das editieren einer *.ACS Datei das ACS.PRG geladen.
PC-Shell - Menü: Extras
=======================
o Resource... ◆K
Auswahl einer Resource-Datei mit dem Fileselektor und starten
des Resource-Editors.
o Debugger...
Auswahl eines Programms mit dem Fileselektor und starten des
Pure Debuggers.
o Profiler...
Auswahl eines Programms mit dem Fileselektor und starten des
Pure Profilers.
(Nicht unter MTOS)
o Modul laden...
Auswahl eines ACS-Moduls (*.AM) mit dem Fileselektor und Laden
des Moduls.
o Diverse... ◆V
Einstellungen
o Desktop-Farbe
Auswahl der Desktopfarbe, ab einer Auflösung >= 16 Farben
(nur Single-TOS).
o Fehlermeldungen
Öffnet das Fehlermeldungen-Fenster.
o Source-Inhalt
öffnet ein Fenster, in dem die Beschreibungen der Source-Dateien
ausgegeben werden. Durch Mausklick auf den Dateinamen, wird
die Datei in den Editor geladen.
o Fenster-Popup ◆W
öffnet ein Popup-Fenster zum Toppen eines PC-Shell - Fensters.
o Fenster ^W
Aktuelles Fenster wechseln.
o PRG starten... ◆E
Starten eines beliebigen Programms, das über den Fileselektor
ausgewählt wird.
o Projekt
- Bei Prg. starten/debuggen Projekt aktualisieren
Bevor das Programm gestartet bzw der Debugger/Profiler aufge-
rufen wird, wird von der PC-Shell das Projekt aktualisert,
d.h.: es werden vor dem Aufruf alle Abhängigkeiten überprüft
und, wenn nötig, eine neue Programmversion gebunden.
- Quelltexte automatisch sichern
Vor dem Starten eines Programms (bzw des Debuggers oder des
Profilers) werden alle Quelltexte automatisch gesichert.
- Im Hintergrund compilieren (Nur MagiC und MTOS)
Ist diese Option ausgewählt, so werden die für die Projekt-
aktualisierung notwendigen Programme (Compiler, Linker, ...)
parallel gestartet.
o Editor
Auswahl des Default-Editors für PC-Shell
- Internen Editor benutzen (PC-Editor)
- Editor 1 benutzen
- Editor 2 benutzen
- ARGV Editor-1/2
Legt fest, ob PC-Shell beim Aufruf des Editors das
ARGV-Protokoll verwendet.
Nicht unter MagiC V2.x selektierbar.
o Allgemein
- Grow/Shrink-Boxen abschalten
Das Zeichnen der Gro/Shrink-Boxen läßt sich mit dieser Option
abschalten.
- Pulldown-Menüs abschalten
Ist diese Option ausgewählt, so werden ein Dropdown-Menü
statt des Pulldown-Menüs im Fenster des internen Editors
verwendet.
- Dialoge in Mauszeigernähe zeichnen
- Mauszeiger verstecken
Ist diese Option ausgewählt, verschwindet der Mauszeiger
sobald eine Taste gedrückt wird und erscheint erst wieder
bei einer Mausbewegung.
- 3D-Effekte abschalten
Die 3D-Effekte bei der Darstellung der Dialoge wird
abgeschaltet.
Nur auf Farbbildschirmen selektierbar.
- Einstellungen automatisch sichern
Beim Verlassen der PC-Shell werden die aktuellen Einstellungen
in der Datei PC_SHELL.INF gesichert.
o Hilfe-Programm
Auswahl der in PC-Shell benutzten Online-Hilfe
- Als Programm starten
Wird das Hilfe-Programm nicht als laufende
Anwendung gefunden, so wird es im Bedarfsfall als Programm
gestartet. Der Pfad und der Dateiname für das zu startende
Hilfe-Programm kann im Dialog 'Optionen/Pfade...' eingestellt
werden.
- PC-Help verwenden
- ST-Guide verwenden
- Hypertext
Ist der ST-Guide ausgewählt, kann man hier die Hypertextdatei
oder die Referenz eintragen, die die PC-Shell bei ihren
Zugriffen auf das Online-Hilfesystem verwenden soll.
In der Regel ist das die Datei PC_SHELL.REF oder aber die
ALL.REF.
o Datei-Extender für Resource-Dateien
Dateien mit der eingestellten Endung werden im Fileselektor
in 'Extras/Resource...' verwendet.
(Typischerweise .RCS für ein Resource Construction Set und
.ACS für ACS).
Die bei der Projekterstellung anfallenden Fehlermeldungen werden
in die Datei ERROR.DAT umgeleitet. Ist die Projekterstellung
beendet, wird der Inhalt der Datei in einem Fenster angezeigt.
Durch einen Einfachklick auf eine Fehlermeldung (ERROR oder
WARNING), wird die Datei in den zugeordneten Editor (bestimmt
durch die Auswahl in 'Optionen/Source-Liste...' bzw
'Extras/Diverse...') geladen. Bei Verwendung des internen Editors
(PC-Editor) wird der Cursor automatisch auf die betreffende
Textstelle gesetzt.
Bei manchen Editoren, wie z.B. EVEREST, ist es auch möglich, das
der Editor, durch Doppelklick auf eine Fehlermeldung, den Cursor
in die dazugehörige Zeile der Sourcedatei setzt.
Durch betätigen der HELP-Taste, wird das eingestellte Hilfe-System
(PC_HELP oder ST-Guide) bei Fehlermeldungen aufgerufen.
PC-Shell - Menü: Hilfe
======================
Unter dem Menüpunkt Hilfe lassen sich verschieden,
wichtige Seiten der Online-Hilfe direkt öffnen:
o PC-Shell...
Öffnen der Main-Seite der Online-Hilfe.
o Menü...
Öffnen der PC-Shell-Menü-Beschreibung in der Online-Hilfe.
o Editor...
Öffnen der Beschreibung des internen Editors der
Online-Hilfe.
o Index...
Öffnen der Index-Seite der Online-Hilfe.
PC-Shell - Editor
=================
Integriert in die PC-Shell ist ein eigener (interner) Editor.
Das Menü des internen Editors enthält die folgenden Einträge:
Datei
Bearbeiten
Suchen
Extras
Tastaturbedienung
Der PC-Editor basiert auf dem Editor, der dem ACS pro V2.17
beiliegt.
PC-Shell - Editor: Datei
========================
o Öffnen...
Es wird eine Datei in den Editor eingelesen. Eine vorher schon
im Editor befindliche Datei wird dabei (im Editor) nach Rückfrage
überschrieben.
o Hinzufügen... ^H
Ab Cursor wird die ausgewählte Datei eingefügt.
o Sichern ^S
Die Datei wird zurückgeschrieben.
o Sichern als... ^M
Die Datei kann unter einem anderen Namen gesichert werden.
o Information...
Es wird die Anzahl der Zeilen und die Größe der Datei
angezeigt.
o Schließen ^U
Der Editor wird geschlossen. Ist die aktuelle Datei noch nicht
gesichert worden, so erfolgt eine Sicherheitsabfrage:
PC-Shell -Editor: Bearbeiten
=================================
o Rückgängig UNDO
Die zuletzt ausgeführte Operation wird zurückgenommen.
o Ausschneiden ^X
Der markierte Block wird in den internen Puffer kopiert und im
Editor gelöscht.
o Kopieren ^C
Der markierte Block wird in den internen Puffer kopiert.
o Einfügen ^V
Der interne Puffer wird ab Cursor in das Editorfenster
geschrieben.
o Zeile aussch. ^Y
Die Zeile, in der sich der Cursor befindet, wird ausgeschnitten,
d.h. in den internen Puffer kopiert und im Editor gelöscht.
o Block markieren ^B
Mit "Block markieren" wird die jeweils aktuelle Cursorposition
als Blockanfang bzw Blockende markiert.
o Links einrücken ^J
o Rechts einrücken ^K
Der markierte Block wir um eine Tabulator-Position nach links
bzw rechts verschoben.
Die Größe von TAB kann unter 'Extras/Optionen..' eingestellt
werden. Der Default ist 8.
PC-Shell - Editor: Suchen
=========================
o Finden... ^F
Im Editfeld kann man den Text eingeben der im aktuellen Editor-
fenster gesucht werden soll.
o Nächster ^G
Die Suche wird mit den unter 'Finde' vorgenommenen Einstellungen
ab der aktuellen Cursorposition fortgesetzt.
o Selektion ^I
Der markierte Block wird als Suchstring übernommen.
o Ersetzen... ^R
In den Editfeldern kann man oben den Text angeben der gesucht
werden soll und darunter den Text, durch den der gesuchte Text
ersetzt werden soll.
o Nächster ^T
Das Ersetzen wird ab der aktuellen Cursorposition mit den unter
'Ersetze' vorgenommenen Einstellungen fortgesetzt.
o Gehe zu... ^L
Positionieren auf eine vorzugebende Zeile (Zeilennummer).
o Setze Marke (CTRL 1, ..., CRTL 4)
Es könne bis zu 4 Marken im Text gesetzt werden.
Durch 'Gehe zu Marke...' kann auf eine so markierte Zeile
direkt positioniert werden.
o Gehe zu Marke... (ALT 1, ..., ALT 4)
Auswahl einer Marke
PC-Shell - Editor: Extras
=========================
o Überschreiben INS
Umschalten zwischen Einfüge- und Überschreibmodus
o Optionen.. ◆T
Selektionen
Auswahl des Selektionsmodes für Blöcke:
- kontinuierlich
Es werden im selektierten Bereich alle Zeilen markiert.
- Spaltenblock
Mit der Maus wird ein Rechteck aufgezogen, das als Block
markiert wird.
Cursor
Auswahl der Cursor-Darstellung im Editorfenster.
Allgemein
- autom. Einrücken
- GEM-Klemmbrett
Anstatt des internen Puffers wird das GEM-Klemmbrett
(Clipboard) verwendet.
TAB
Einstellen der Tabulatorweite (Default: 8).
o Help-ACC HELP
Das unter dem Cursor befindliche Wort wird an das eingestellte
Hilfesystem übergeben.
o Projekt-Suche ⇧HELP
Für das unter dem Cursor befindliche Wort wird eine Projekt-Suche
gestartet.
o Fonts...
Im Fontselektor kann ein nicht-proportionaler GDOS-Font ausge-
wählt werden, der zur Darstellung im PC-Editor benutzt werden
soll.
o Einst. sichern
Die Editor-Einstellungen werden in der Datei EDITOR.CFG gesichert.
Die Datei wird in dem Dierctory erzeugt, in dem sich auch
PC_SHELL.APP befindet.
Tastaturbedienung des PC-Editors
================================
o CURSOR-Links
CURSOR-Rechts
CURSOR-Oben
CURSOR-Unten
Cursor-Positionierung um ein Zeichen nach links/rechts/oben/unten
verändern.
o SHIFT CURSOR-Links
SHIFT CURSOR-Rechts
Cursor auf Zeilenanfang bzw -ende positionieren.
o SHIFT CURSOR-Oben
SHIFT CURSOR-Unten
Eine Seite zurück/vorwärts blättern
o CONTROL CURSOR-Links
CONTROL CURSOR-Rechts
Cursor auf vorherigen/nächsten Wortanfang positionieren.
o HOME
Auf die 1. Zeile der Datei positionieren.
o SHIFT HOME
Auf die letzte Zeile der Datei positionieren.
o HELP
Aufruf der Online-Hilfe (PC_HELP oder ST-Guide) für das Wort,
das sich an der Cursorposition befindet.
o SHIFT HELP
Projektsuche für das Wort, das sich an der Cursorposition
befindet.
o INS
Umschalten vom Insert- in den Überschreibmodus und zurück.
o UNDO
Die zuletzt ausgeführte Operation wird zurückgenommen.
o CONTROL 1
CONTROL 2
CONTROL 3
CONTROL 4
Marke 1 - 4 setzen
o CONTROL B
Mit "Block markieren" wird die jeweils aktuelle Cursorposition
als Blockanfang bzw Blockende markiert.
o CONTROL C
Der markierte Block wird in den internen Puffer kopiert.
GEM-Klemmbrett: Der markierte Block wird im Clipboard als Datei
SCRAP.TXT abgelegt
o SHIFT CONTROL C
GEM-Klemmbrett: Der markierte Block wird im Clipboard an den
Inhalt der Datei SCRAP.TXT angehängt.
o CONTROL F
String suchen.
o CONTROL G
Weitersuchen.
o CONTROL H
Ab Cursor wird die ausgewählte Datei eingefügt.
o CONTROL I
Der markierte Block wird als Suchstring übernommen.
o CONTROL J
Der markierte Block wir um eine Tabulator-Position nach links
verschoben.
o CONTROL K
Der markierte Block wir um eine Tabulator-Position nach rechts
verschoben.
o CONTROL L
Positionieren auf die angegebene Zeile.
o CONTROL M
Die Datei kann unter einem anderen Namen gesichert werden.
o CONTROL R
String durch einen anderen String ersetzen.
o CONTROL S
Die Datei wird zurückgeschrieben.
o CONTROL T
Ersetzung wiederholen.
o CONTROL U
Der Editor wird geschlossen. Ist die aktuelle Datei noch nicht
gesichert worden, so erfolgt eine Sicherheitsabfrage.
o CONTROL V
Der interne Puffer wird ab Cursor in das Editorfenster
geschrieben.
GEM-Klemmbrett: Der Inhalt der Datei SCRAP.TXT wird ab Cursor
in das Editorfenster geschrieben.
o CONTROL X
Der markierte Block wird in den internen Puffer kopiert und im
Editor gelöscht.
GEM-Klemmbrett: Der markierte Block wird im Clipboard als Datei
SCRAP.TXT abgelegt und im Editor gelöscht.
o CONTROL Y
Die Zeile, in der sich der Cursor befindet, wird ausgeschnitten,
d.h. in den internen Puffer kopiert und im Editor gelöscht.
GEM-Klemmbrett: Die Zeile wird im Clipboard in der Datei
SCRAP.TXT abgelegt und im Editor gelöscht.
o ALTERNATE 1
ALTERNATE 2
ALTERNATE 3
ALTERNATE 4
Marke 1 - 4 anspringen
o ALTERNATE T
PC-Editor Optionen-Dialog aufrufen.
PC-Projekt
==========
Das jeweils aktuelle PC-Shell-Projekt wird im sogennanten
Projektfenster dargestellt. Das Projektfenster besteht aus zwei
Listboxen, jeweils einer für Source-Dateien (max. 500) und einer
für Library-Dateien (max. 100). Die Auswahl und Bearbeiten der
Source- und Library-Dateien geschieht durch Drag & Drop. Für die
Bedienung der Abhängigkeiten-Listbox gilt das unten beschriebene
auch.
Die Source-Dateien werden bei der Projekterstellung ('Compiler/Make'
oder 'Compiler/Make All') folgendermaßen bearbeitet:
- *.C Dateien werden compiliert
- *.S Dateien werden assembliert
- *.O Dateien werden hinzugelinkt
- *.LIB Dateien werden hinzugelinkt
- *.PC Das Subprojekt wird aktualisiert
- *.PRJ Das Subprojekt wird aktualisiert
alle anderen Dateien werden ignoriert oder es wird für sie der
ausgewählte Source-Compiler gestartet. So kann man z.B. auch
Headerdateien (*.H) mit in die Source-Dateien-Liste übernehmen,
um sie zum editieren nicht suchen zu müssen.
Ist ein Subprojekt (*.PC bzw *.PRJ) angegeben, so wird es (wenn
nötig) aktualisiert. Ist das Ergebnis ein Objekt (*.O bzw *.LIB),
so wird es zum aktuellen Projekt hinzugebunden.
Subprojekte können auch Subprojekte beinhalten.
Die Library-Dateien müssen sich im Library-Directory befinden.
(siehe 'Optionen/Linker...')
Wenn die Reihenfolge der Dateien wichtig ist, können einfach alle
Dateien (inkl. LIB's) in die Source-Liste (in der gewünschten
Reihenfolge) eingetragen werden. Die Library-Liste bleibt dann
leer.
Projektfenster
Source-Beschreibung
Source-Compiler
Wird das Projekt geschlossen, bevor Veränderungen, die in der
.PC-Datei enthalten sind, gesichert wurden, erscheint eine
Sicherheitsabfrage.
Ausnahme: Im Dialog 'Extras/Diverse...' ist die Option
"Einstellungen automatisch sichern" ausgewählt.
PC-Shell - Projektfenster
=========================
Beschreibung der Bedienelemente
Tastaturbedienung
Cursorbedienung
Projektfenster: Beschreibung der Bedienelemente
===============================================
o ?
PC-Shell Programminfo
(Entspricht dem Aufruf von 'PC_SHELL/Info...')
o Prg.-Name Dialog ◆N
o Icon Source ◆S
Auswählen von Source-Dateien im Fileselektor.
(Selectric wird unterstützt)
o Icon Library ◆L
Auswählen von Library-Dateien im Fileselektor.
(Selectric wird unterstützt)
o Klemmbrett ^C / ^V
speichern : Ziehen von Source- oder/und Library-Dateien auf das
Klemmbrett.
laden : Ziehen des Klemmbrettes in die Source- oder
Library-Listbox
o Mülleimer ^D
Löschen : Ziehen von Source- oder/und Library-Dateien auf den
Mülleimer.
o Edit ^E
Editieren : Ziehen von Source-Dateien auf das Edit-Icon, oder
Source-Dateien selektieren und Klick auf das
Editor-Icon.
Durch Doppelklick auf eine Source-Datei, wird diese
in den Editor geladen.
o Arbeit ^B
Compilieren/Assemblieren/Source-Compiler
Ziehen von Source-Dateien auf das Arbeit-Icon, oder
Source-Dateien selektieren und Klick auf das Arbeit-Icon.
Wird ein Subprojekt-Eintrag auf das Arbeit-Icon gezogen, so
wird ein 'Make All' für das Subprojekt durchgeführt.
o Option ^I
Abhängigkeiten, lokale Compiler- bzw. Assembleroptionen und
Hilfstexte (Source-Inhalt) einstellen. Es wird unterschieden
zwischen
- C- und Assemblersourcen
- andere Dateien
Projektfenster: Tastaturbedienung
=================================
- Source neu (◆S)
- Library neu (◆L)
- Klemmbrett (speichern = ^C, laden ^V)
nur selektierte Einträge werden bearbeitet.
- Mülleimer (^D)
nur selektierte Einträge werden bearbeitet.
- Edit (^E)
nur selektierte Einträge werden bearbeitet.
- Arbeit (^B)
nur selektierte Einträge werden bearbeitet.
- Option (^I)
nur selektierte Einträge werden bearbeitet.
Projektfenster: Cursorbedienung
===============================
- Cursor anschalten
Cursor-Up, -Down, -Left oder -Right.
- Cursor nach oben
Cursor-Up mit SHIFT seitenweise.
- Cursor nach unten
Cursor-Down mit SHIFT seitenweise.
- Listbox wechseln
Cursor Right bzw. Left.
- Alle Einträge in der Listbox, in der sich (^A)
der Cursor befindet, selektieren.
- Eintrag unter dem Cursor selektieren
INSERT selektieren mehrerer Einträge mit Hilfe der
SHIFT-Taste.
- Einträge deselektieren
DELETE deselektieren nur eines Eintrages mit Hilfe der
Shift-Taste.
Projektfenster: Prg.-Name
o Pfad ◆P
Verzeichnis, in dem die unter Programm-Name angelegte Datei
abgelegt wird.
o Programm-Name
Name des Programms, das im Projekt gebunden wird.
Dateien mit der Extention .AM werden als ACS-Module betrachtet
und geladen.
o Kommandozeile
Kommandozeile, mit der das Programm unter
'Compiler/Prg. starten' aufgerufen wird.
Projektfenster: Option (Sourcen)
================================
In der Listbox können für die in der Source-Listbox ausgewählte
Datei weitere Dateien eingetragen werden, von denen die
ausgewählte Datei abhängt (typischerweise .H - Dateien bei
C-Sourcen).
o Neu ^N
Mit dem Fileselektor kann eine Datei ausgewählt werden, die
in die Abhängigkeitsliste eingetragen wird.
o Clipboard ^C / ^V
o Mülleimer ^D
Die in der Listbox selektierten Dateien werden aus der Listbox
entfernt.
o 'includes' ermitteln ◆i
Es werden alle #include - Dateien ermittelt, von der die Source
abhängt und in die Abhängigkeitenliste eingetragen.
Diese Funktion soll die Erstellung der Abhängigkeitenliste ver-
einfachen. Es werden hier immer alle #include - Dateien einge-
tragen, d.h.: auch #include - Dateien die nur durch "conditonal
compiling" inkludiert werden, z.B.:
#ifdef DEBUG
#include "debug.h"
#endif
wird auch dann inkludiert, wenn das Makro DEBUG nicht definiert
ist.
o Optionen ◆p
Einstellen der Compiler/Assembler-Optionen für die ausgewählte
Datei. Vor Aufruf von Optionen (◆p) kann man auswählen, welches
die Default-Compileroptionen seien sollen:
- globale Optionen ◆g
Es sind die Compiler-/Assembleroptionen gesetzt, die in
'Optionen/Compiler...' bzw in
'Optionen/Assembler...' eingestellt sind.
- lokale Optionen ◆l
Es werden nur die lokalen Compiler/Assembler-Optionen
verwendet. Die voreingestellten globalen Optionen werden in
in diesem Fall nicht berücksichtigt.
==> C-Sourcen
==> Assemblersourcen
o Source-Inhalt ◆S
Anschauen/verändern der Dateibeschreibung
Projektfenster: Option (Dateien)
================================
Für alle Dateien in der Source-Listbox, die keine C- oder
Assemblersourcen sind, kann ein Source-Compiler (nur *.TOS oder
*.TTP) angegeben werden. Dieses Programm wird nur dann gestartet
('Compiler/Make', 'Compiler/Make All' und Icon 'Arbeit') wenn die
Sourcedatei ein neueres Datum hat, als die Zieldatei (kann unter
'Zeitvergleich mit:' angegeben werden).
o Program ◆P
Auswahl des Source-Compilers mit dem Fileselektor.
o Kommandozeile
Kommandozeile, die beim Aufruf des Source-Compilers benutzt
werden soll.
o Source-Compiler benutzen ◆c
Nur wenn der Schalter ausgewählt ist, wird der Source-Compiler
für die Datei aufgerufen. Vor Aufruf des Source-Compilers wird
der aktuelle Projekt-Pfad gesetzt, sodaß nur der Name der
Sourcedatei übergeben werden muß.
o Source ◆r
Der Button bewirkt, daß der Name der Datei an die Kommandozeile
angehängt wird.
o Zeitvergleich mit ◆Z
o Source-Inhalt ◆S
Anschauen/verändern der Beschreibung
Projektfenster: Optionen: Compileroptionen
==========================================
Die Maske stimmt im wesentlichen mit der Maske für die allgemeinen
Compileroptionen in 'Optionen/Compiler...' überein.
Zusätzlich steht hier die Option
O - Objekt-Datei umbenennen
zur Verfügung. Die Objektdatei wird nicht unter ihrem Defaultnamen
(z.B. SAMPLE.C --> SAMPLE.O) abgelegt, sondern unter dem hier ange-
gebenen Namen. Ist keine Extention angegeben, so wird die Extention
".O" verwendet.
Projektfenster: Optionen: Assembleroptionen
===========================================
Die Maske stimmt im wesentlichen mit der Maske für die allgemeinen
Assembleroptionen in 'Optionen/Assembler...' überein.
Zusätzlich steht hier die Option
O - Objekt-Datei umbenennen
zur Verfügung. Die Objektdatei wird nicht unter ihrem Defaultnamen
(z.B. SAMPLE.S --> SAMPLE.O) abgelegt, sondern unter dem hier ange-
gebenen Namen. Ist keine Extention angegeben, so wird die Extention
".O" verwendet.
Source-Beschreibung
===================
Zu jeder Datei in der Source-Listbox im Projektfenster kann eine
Beschreibung eingegeben werden. Für die Beschreibungen gilt:
- Maximale Größe je Beschreibung ist 32KBytes.
- Die Beschreibungen werden in der zugehörigen .PC - Projektdatei
gespeichert.
- Clipboard-Unterstützung (^C, ^X, ^V, ^Y)
Shareware
=========
PC-Shell ist Shareware
Registrierung, Kritik, Fragen und Anregungen zur PC-Shell an
Frank Schramm
Kasperstraße 5
D-21647 Moisburg
Tel.: 04165-6173
MausNet : Frank Schramm @ HH2
Bankverbindung: StSpk Buxtehude
BLZ: 241 520 80
Kto: 876235
Die Benutzung von PC-Shell kostet DM 20.- (Bar, Scheck oder
Überweisung) an den Autor.
Ab der Version 2.19 ist die PC-Shell leicht eingeschränkt, bei
der unregistrierten Version erscheint vor dem Compilieren eine
Dialogbox, die auf den Shareware-Status hinweist. Die Registrierung
erfolgt durch einen persönlichen Schlüssel.
Wichtig ist bei Überweisungen, daß die komplette Anschrift
angegeben wird, ggf. auch die Telefonnummer oder E-Mail-Anschrift
(MausNet). Der Registrierungs-Schlüssel wird nach erfolgter
Bezahlung, nach Wunsch telefonisch, per Brief oder per E-Mail
(MausNet) mitgeteilt.
Registrierte Benutzer können jederzeit, durch zusenden einer
formatierten Diskette und einem frankiertem Rückumschlag, die
neueste Version beim Autor bekommen.
HAFTUNGSAUSSCHLUSS
PC-Shell wurde ausführlich getestet. Für etwaige Schäden, die
durch die Verwendung von PC-Shell entstehen, kann der Autor
keine Haftung übernehmen.
Lieferumfang
============
Die aktuelle PC-Shell-Version wird als Archiv
PC_300.LZH
zur Verfügung gestellt. In diesem Archiv befinden sich die
folgenden Dateien:
- PC_SHELL.APP
PC-Shell - Programm
- PC_SHELL.AM
ACS-Modul zum Bearbeiten von Unterprojekten.
(Muß im gleichen Verzeichnis sein, wie PC_SHELL.APP)
Wird erst bei Bedarf nachgeladen. Bei Änderung des Modulnamens
auf PC_SHELL.AMA wird das Modul beim Start der PC-Shell gleich
mitgeladen.
- PARALLEL.TTP
Dieses Programm wird von PC-Shell unter MTOS und MagiC zum
Compilieren im Hintergrund benötigt.
(Muß im gleichen Verzeichnis sein, wie PC_SHELL.APP)
Bei MagiC muß VT52.PRG installiert sein.
- PC_SHELL.HYP, PC_SHELL.REF
Online-Hilfe im ST-Guide-Format
- PC_SHELL.TXT
PC-Shell-Anleitung im ASCII-Format.
- CHANGES.TXT
Beschreibung der Versionsänderungen
- PC_SHELL.UPL
Upload-Text für Mailboxen.
- ST_GUIDE.TXT
Eine Beschreibung zur Konvertierung der Dateien C.HLP, LIB.HLP
und PASM.HLP aus dem Pure C - Systems in das ST-Guide - Format.
Unterstützt wird die derzeit aktuelle Pure C - Version V1.1 vom
20.03.1993.
PC-Shell läuft auf TOS-Versionen >=1.04, MTOS und MagiC und einer
Mindestauflösung mit 640 Pixeln Breite und 400 Pixeln Höhe.
ACS-Module laden ist möglich für Module, die mit der ACS V2.20
(oder höher) erstellt wurden.
Hardware: ST/STE/TT/Falcon030.
Installation
============
Zuerst müssen die Dateien aus dem LHARC-Archiv extrahiert werden.
(Alle Dateien befinden sich im Directory PC_SHELL.300 bzw in den
Subdirectories DOKU und PC_HYP)
- PC_SHELL.APP
In das gewünschte Verzeichnis kopieren.
- PC_SHELL.AM
ACS-Modul zum Bearbeiten von Unterprojekten.
(Muß im gleichen Verzeichnis sein, wie PC_SHELL.APP)
Wird erst bei Bedarf nachgeladen. Bei Änderung des Modulnamens
auf PC_SHELL.AMA wird das Modul beim Start der PC-Shell gleich
mitgeladen.
- PARALLEL.TTP
Dieses Programm wird von PC_SHELL.APP unter MTOS und MagiC zum
Compilieren im Hintergrund benötigt. Es muß sich in diesem
Fall im gleichen Verzeichnis befinden, wie PC_SHELL.APP.
Bei MagiC muß VT52.PRG installiert sein.
- PC_SHELL.UPL
Diese Datei wird für die Arbeit mit PC_SHELL.APP nicht benötigt.
- DOKU\CHANGES.TXT
Diese Datei wird für die Arbeit mit PC_SHELL.APP nicht benötigt.
- DOKU\PC_SHELL.TXT
Diese Datei wird für die Arbeit mit PC_SHELL.APP nicht benötigt.
- PC_HYP\PC_SHELL.HYP
Online-Hilfe im ST-Guide-Format.
Diese Datei kopiert man in eines der Verzeichnisse, die in der
Datei ST-GUIDE.INF der Variablen PATHS ("Suchpfadliste für
externe Referenzen") zugeordnet sind.
- PC_HYP\PC_SHELL.REF
REF-Datei für PC_SHELL.HYP.
Die Datei PC_SHELL.REF kopiert man in das selbe Directory wie die
Datei PC_SHELL.HYP. Alternativ kann man den Inhalt mittels RefLink
in die ALL.REF eintragen.
- PC_HYP\ST_GUIDE.TXT
Diese Datei wird für die Arbeit mit PC_SHELL.APP nicht benötigt.
PC-Shell verwendet die folgenden Konfigurationsdateien:
- PC_SHELL.DEF
Default-Einstellungen für neue Projekte ('Datei/PC neu...').
(Ab PC-Shell V2.22)
- PC_SHELL.INF
Allgemeine Einstellungen der PC-Shell.
(Ab PC-Shell V2.20)
- EDITOR.CFG
Einstellungen des PC-Editors (Fensterkoordinaten, Font, ...).
(Siehe 'Extras/Einst. sichern' im Menü des PC-Editors).
(Ab PC-Shell V2.22)
Alle drei Dateien befinden sich im Directory, in dem auch die
PC-Shell abgelegt ist. Die in Klammern angegebene PC-Shell-Version
gibt an, bis zu welcher älteren Version diese Dateien in die Version
V3.00 übernommen werden können.
Die PC-Shell legt während der Laufzeit die folgenden Dateien an:
- ERROR.DAT
Datei für die Fehlermeldungen.
Befindet sich im Source-Pfad.
(Siehe 'Extras/Fehlermeldungen')
- PARALLEL.INF
INF-Datei für das Programm PARALLEL.TTP.
Temporäre Datei. Befindet sich im Source-Pfad.
- PCC.CFG
Batchdatei für PCC.TTP.
Zur Übergabe von Parametern an den Compiler
Temporäre Datei. Befindet sich im Source-Pfad.
- PCLINK.CFG
Batchdatei für PLINK.TTP
Zur Übergabe von Parametern an den Linker
Temporäre Datei. Befindet sich im Source-Pfad.
PC-Shell History
================
Version 3.00 (17.06.1995)
o Unterstützung von Subprojekten.
Projekte können weitere (Sub-) Projekte als Abhängigkeiten
enthalten.
(Bearbeitung durch das ACS-Modul PC_SHELL.AM)
o Projektbezogene Include-Pfade
(4 für Compiler/ 2 für Assembler)
Abspeicherung erfolgt in der jeweiligen Projektdatei
(*.PC bzw *.PRJ)
o Durch ein Fenster-Popup (Liste der geöffneten Fenster) können
die einzelnen Fenster getoppt werden.
o Zusätzliche Source-Editoren mit konfigurierbaren Extendern.
('Optionen/Source-Liste...')
o VA_START - Unterstützung für externe Editoren.
o Fehlerbeseitigung:
- Diverse kleine Fehler beseitigt.
- Farbicons unter MagiC 3.0 funktionsfähig.
Version 2.24 (18.01.1995)
o Button 'includes ermitteln' im Abhängigkeiten-Dialog
(Dank an Jan Starzynski @ HRO für die Sourcen)
o Compilierung im Hintergrund jetzt auch für MTOS
o ST-Guide Unterstützung.
o Anleitung im ST-Guide - Format (Kontext-Hilfe)
o Neue Schalter im Dialog 'Extras/Diverse...':
- Einstellungen automatisch sichern.
- Im Hintergrund compilieren (MTOS/MagiC)
o Interner Editor
- 'Shift Help' startet eine Projektsuche.
- Wortweises Springen mit 'CTRL Left' bzw. 'CTRL Right'
- Marke setzen mit CTRL 1-4
- Zu Marke springen mit ALT 1-4
- Block einrücken
o Pure-Profiler starten, über den Menüpunkt 'Extras/Profiler...'
und den Menüpunkt 'Compiler/Prg. profilen'
(Nicht unter MTOS)
o ACS-Module laden, über den Menüpunkt 'Extras/Modul laden...'
(Ab ACS V2.20)
Der zuletzt eingestellte Modulpfad wird in der INF-Datei gesichert.
o Fehlerbeseitigung:
- In der Kommandozeile ließen sich nur Großbuchstaben eingeben.
- Ausblenden unter MagiC funktioniert jetzt.
- Ein paar kleine Fehler in den Editor-Blockfunktionen beseitigt.
Version 2.23 (12.11.1994)
o Für jede Source-Datei kann ein Hilfstext (z.B. Beschreibung des
Inhalts) eingegeben werden.
o Bei 'Prg. starten' kann jetzt eine Kommandozeile übergeben werden.
(Prg.-Name Dialog)
o Für alle Dateien in der Source-Liste (ausgenommen sind *.C und
*.S) kann ein Source-Compiler (nur *.TOS oder *.TTP) angegeben
werden. Dadurch können z.B. Hypertexte für ST-GUIDE gleich mit
compiliert werden.
o abschaltbare 3D-Dialoge.
o Auswahl der Desktop-Farbe (nur Single-TOS).
o Editor: Shift+Ctrl+C = der selektierte Block wird an eine, im
GEM-Clipboard vorhandene, SCRAP.TXT Datei angehängt.
o Fehlerbeseitigung:
- Diverse kleine Fehler beseitigt.
- Fehler bei der PRJ-Auswertung beseitigt.
Version 2.22 (11.08.1994)
o Beenden des Compiliervorgangs usw. durch LinksSHIFT + RechtsSHIFT.
o Neue Menüpunkte: 'INF laden...' und
'INF sichern...'
o Fehlerbeseitigung:
- Unter MagiC gab es Probleme, wenn der Schalter
'Projekt aktualisieren' verwendet wurde.
- Die Probleme mit den Editor-Fensterkoordinaten müßten
beseitigt sein. Sollten noch Fehler auftreten -> EDITOR.CFG
löschen.
- Diverse kleine Fehler beseitigt.
Version 2.21
o Sichern der Editor-Fensterkoordinaten in EDITOR.CFG
o Fehlerbeseitigung:
- Unter MagiC gab es Probleme beim Linken.
Version 2.20
o Die PureC-TTP's werden unter MagiC parallel gestartet.
o Der 'warning level' ist jetzt im Compileroptionen- Dialog
auswählbar.
o 'PRJ öffnen' ist funktionsfähig.
o Default-Einstellungen sichern (für 'PC neu...'), von:
- Compiler-, Assembler und Linker-Optionen
- Librarydateien
- Pfad für den Prg-Namen
o Neuer Menü-Eintrag: 'Linken'
o Zusätzliche Include-Pfade für Compiler und Assembler.
o Durch betätigen der HELP-Taste im Fehlermeldungen-Fenster,
wird die PureC-Hilfe für Fehlermeldungen aufgerufen.
o Fehlerbeseitigung:
- Unter MagiC mit Farbauflösung, wurden die Icons im
Projektfenster nicht gezeichnet.
- Diverse kleine Fehler beseitigt.
Version 2.19
o Projekt-Fenster auf Drag&Drop umgestellt.
o Unregistrierte Version leicht eingeschränkt.
(Dialogbox erscheint vor dem Compilieren).
o Kommandozeile wird jetzt ausgewertet, eine *.PC- Datei wird
geladen.
o Internen Editor überarbeitet:
- Unterstützung des GEM-Clipboards.
- Blockselektion mit der Tastatur (^B/^K)
o Projekt-Suche eingebaut.
o Das PC_HELP.ACC kann jetzt auch als Programm verwendet werden.
(siehe Pfade... und Diverse... Dialog)
o Fehlerbeseitigung:
- Beim Suchen im internen Editor, wurde ein 'Bing' mit
Bconout(2, 7) an die Konsole gesandt. Unter TOS 1.06
(1040STE) + NVDI stürzt dann der Rechner ab. Der Fehler
liegt im TOS 1.06, deshalb wurde das 'Bing' herausgenommen.
Version 2.18
o Abhängigkeiten-Dialog geändert:
- Listbox (max. 100 Einträge)
- Drag&Drop (Neu/Klemmbrett/Mülleimer Icons)
- Die Abhängigkeitsdateien müssen jetzt nicht mehr
im gleichen Verzeichnis liegen wie die Sourcedatei.
o Das Textfeld 'Compiler Zusatz-Optionen' vergrößert.
o Zusätzliche Optionen im Assembler-Optionen Dialog.
o Die compilierten Objektdateien können jetzt auch umbenannt oder
in einem anderen Verzeichnis abgelegt werden.
(Compiler- und Assembleroption: -N und -O)
o Im Programm-Namen Dialog kann auch ein anderes Verzeichnis
angegeben werden.
o Das Format der Projektdateien *.PC hat sich geändert.
Projektdateien ab Version 2.17d können geladen werden.
o Zwei zusätzliche Schalter im Diverse-Dialog:
1. Bei Prg. starten/debuggen Projekt aktualisieren (Make)
2. Quelltexte automatisch sichern.
bei: - Aufruf von Programmen
(Debugger, RCS, ext. Editor usw.).
- PC-Shell beenden.
- Compileraufrufen
(Make/Make All/Assemblieren/usw).
o Fehlerbeseitigung:
- Unter einem Multitasking-System konnte bei geöffneter Dialogbox
die Menüzeile mit der Tastatur bedient werden.
- Bei der 2.17d konnten geöffnete Editor-Fenster nicht in der
PC_SHELL.INF abgespeichert werden.
Version 2.17d
o Alle Dialoge sind jetzt applikationsmodale Fensterdialoge.
o Im Pfade-Dialog können Parameter für die externen Editoren
angegeben werden.
Version 2.17c
o Die Source-Dateien müssen sich jetzt nicht mehr, mit der
Projektdatei im gleichen Verzeichnis befinden.
Version 2.17b
o Zusätzlicher Menüpunkt 'Prg. debuggen'.
Version 2.17
o Die Checkboxen und Radiobuttons, sind jetzt auch über den
dazugehörigen Text selektierbar.
o Die modalen Dialoge fliegen jetzt auch mit Let'em Fly.
o Mit dem Menüpunkt 'Fehlermeldungen' (Extras) wird das
Fehlermeldungen-Fenster vom Desktop geöffnet.
o Bei 'INF sichern' wird nun die geöffnete Projektdatei, und alle
geöffneten Fenster in die PC_SHELL.INF übernommen.
o Die INCLUDE-, LIB-Directory und Startup (Optionen) Textfelder
vergrößert und sie können jetzt über den Fileselektor ausgewählt
werden.
o Die PC_SHELL.INF ist nicht mehr kompatibel, zur vorherigen
Version.
o Fehlerbeseitigung:
- Auf dem Falcon030 funktionierten die Tastaturkürzel für die
Menüzeile nicht einwandfrei.
- PC-Shell stürzte ab, wenn bei 'PC öffnen...' eine nicht
vorhandene Datei angegeben wurde.
- Programmaufrufe funktionieren jetzt auch unter MagiC!
Version 2.16b
o Fehlerbeseitigung:
- PC-Shell stürzte beim beenden ab, wenn Let'em Fly mit
eingeschalteter Niceline-Option verwendet wurde.
Version 2.16
o Erste öffentliche Version